MinilibX_05_Events(완료)

Events

Introduction

이벤트들은 mlx 안에서 대화식 어플리케이션의 근간이라고 볼 수 있습니다. 그러므로 차후의 그래픽 프로젝트에서도 사용될 것이므로 이 챕터를 완벽하게 이해하는 것은 필수라고 할 수 있습니다.

모든 mlx 의 hook 들은 이벤트가 발생할 때마다 호출되어지는 함수 그 이상도 그 이하도 아닙니다. 모든 이벤트 함수들을 완벽하게 숙지하는 것은 필수는 아니지만, 각 X11 이벤트들에 따라서 빠르게 검토해보고 정확하게 용도를 파악해두는 것은 향후를 위해 매우 중요한 부분입니다.
1. MacOS version 주) Mac OS 에서 Cocoa(Appkit) 그리고 OpenGL 버전은 부분적으로 X11 이벤트를 지원하지만, X11 mask는 지원하지 않는다(mlx의 x_mask 인자는 쓸모가 없으므로 0으로 두시면 됩니다.).
2. 지원 이벤트들 :
```
enum {
	ON_KEYDOWN = 2,
	ON_KEYUP = 3,
	ON_MOUSEDOWN = 4,
	ON_MOUSEUP = 5,
	ON_MOUSEMOVE = 6,
	ON_EXPOSE = 12,
	ON_DESTROY = 17
};

// usage:
mlx_hook(vars.win, ON_DESTROY, 0, close, &vars);
// '0' == x11_mask
```

X11 interface

X11 은 mlx와 함께 사용되는 라이브러리 입니다.

X11 events

다양한 이벤트 들이 존재합니다.

Key	Event	Key	Event	Key	Event
02	KeyPess	14	NoExpose	26	CirculateNotify
03	KeyRelease	15	VisibilityNotify	27	CirculateRequest
04	ButtonPress	16	CreateNotify	28	PropertyNotify
05	ButtonRelease	17	DestroyNotify	29	SelectionClear
06	MotionNotify	18	UnmapNotify	30	SelectionRequest
07	EnterNotify	19	MapNotify	31	SelectionNotify
08	LeaveNotify	20	MapRequest	32	ColormapNotify
09	FocusIn	21	ReparentNotify	33	ClientMessage
10	FocusOut	22	ConfigureNotify	34	MappingNotify
11	KeymapNotify	23	ConfigureRequest	35	GenericEvent
12	Expose	24	GravityNotify	36	LASTEvent
13	GraphicsExpose	25	ResizeRequest

만약 몇몇 이벤트들이 무엇인지 알기 어려울 수 있지만, 걱정마세요. 실제로 필요한 이벤트는 몇 가지 없고, 이또한 보시면 확실히 아실 수 있을 것입니다. 그럼에도 추가적인 정보가 필요하시면 이 문서를 읽으시면 됩니다. [링크]

X11 masks

각 X11 이벤트들은 해당하는 mask도 있습니다. 이 방식은 특정한 키에 대해 등록할 수 있거나, 혹은 마스크를 기본값으로 두는 경우 모든 키를 등록하는 것이 가능합니다. 그러므로 key mask 는 당신의 특정한 이벤트를 위한 이벤트들을 화이트리스트, 블랙리스트화 하는 것을 허락하게 만들어줍니다. 아래가 할당된 마스크 값들입니다.

Mask	Description	Mask	Description
0L	NoEventMask	(1L<<12)	Button5MotionMask
(1L<<0)	KeyPressMask	(1L<<13)	ButtonMotionMask
(1L<<1)	KeyReleaseMask	(1L<<14)	KeymapStateMask
(1L<<2)	ButtonPressMask	(1L<<15)	ExposureMask
(1L<<3)	ButtonReleaseMask	(1L<<16)	VisibilityChangeMask
(1L<<4)	EnterWindowMask	(1L<<17)	StructureNotifyMask
(1L<<5)	LeaveWindowMask	(1L<<18)	ResizeRedirectMask
(1L<<6)	PointerMotionMask	(1L<<19)	SubstructureNotifyMask
(1L<<7)	PointerMotionHintMask	(1L<<20)	SubstructureRedirectMask
(1L<<8)	Button1MotionMask	(1L<<21)	FocusChangeMask
(1L<<9)	Button2MotionMask	(1L<<22)	PropertyChangeMask
(1L<<10)	Button3MotionMask	(1L<<23)	ColormapChangeMask
(1L<<11)	Button4MotionMask	(1L<<24)	OwnerGrabButtonMask

Hooking into events

mlx_hook

이벤트들로부터 hooking 은 mlx가 제공하는 가장 강력한 도구 중에 하나입니다. 단순한 hook은 등록 함수를 호출함과 함께 앞서 언급한 이벤트들의 종류를 등록하는걸 돕습니다.

이걸 위해, 우리는 mlx_hook 함수를 사용합니다.
```
void mlx_hook(mlx_win_list_t *win_ptr, int x_event, int x_mask, int (*f)(), void *param)
```
주의) 몇몇 mlx 버전에 따라 x_mask 를 수행하지 않고, 무슨 값이든지간에 마스크가 존재하지 않을 수 있습니다.

Prototype of event functions

mlx_hook 를 사용하여 함수를 호출 시, 각 이벤트 코드들에 맞춰 mlx_hook가 제공해주는 패러미터들은 다르게 설정되어 있습니다. 즉, 특정 함수를 작성, 호출 시 지정된 prototype으로 설정하면, 해당하는 값을 받아냅니다. 보시는 바 처럼, ON_KEYDOWN 의 경우, 호출 될 함수를 작성하고, ON_KEYDOWN에 해당하는 프로토 타입을 전달하게 되면, 이에 맞는 프로토 타입int(*f)(int keycode, void *param)을 전달해줍니다.

Hooking event	code	Prototype
ON_KEYDOWN	2	int (f)(int keycode, void param)
ON_KEYUP*	3	int (f)(int keycode, void param)
ON_MOUSEDOWN*	4	int (f)(int button, int x, int y, void param)
ON_MOUSEUP	5	int (f)(int button, int x, int y, void param)
ON_MOUSEMOVE	6	int (f)(int x, int y, void param)
ON_EXPOSE*	12	int (f)(void param)
ON_DESTROY	17	int (f)(void param)

는 mlx_hook를 앨리아스 이다.

Hooking alias

mlx api 는 몇가지 앨리아스 hooking 함수를 갖고 있습니다. 이를 사용하는 것은, 좀더 특정한 후킹을 위해 사용한다고 보시면 됩니다.
- mlx_expose_hook : 노출 이벤트(12) 에 대한 mlx_hook 의 앨리아스 함수이다.
- mlx_key_hook : key up 이벤트(3)에 대한 mlx_hook의 앨리아스 함수이다.
- mlx_mouse_hook : 마우스 다운 이벤트(4) 에 대한 mlx_hook의 앨리아스 함수이다.

Usage Example

mlx_key_hook 의 호출 대신의 예시로 keypress 그리고 keyRelease 이벤트를 등록할 수 있습니다. 이제 키를 누르게 되면 창은 닫히게 될 것이다.

#include <mlx.h>

typedef struct	s_vars {
	void	*mlx;
	void	*win;
}				t_vars;

int	close(int keycode, t_vars *vars)
{
	mlx_destroy_window(vars->mlx, vars->win);
	return (0);
}

int	main(void)
{
	t_vars	vars;

	vars.mlx = mlx_init();
	vars.win = mlx_new_window(vars.mlx, 1920, 1080, "Hello world!");
	mlx_hook(vars.win, 2, 1L<<0, close, &vars);
	mlx_loop(vars.mlx);
}

Test your skils!

이제 애매한 아이디어들을 어떻게 구체적으로 작동시키게 만들지를 생각해봅시다.
- ESC 를 누르면, 창을 종료되게 만든다.
- 창 사이즈가 변경이 되면, 이에 따라 터미널에 무언가 출력되게 만든다.
- (맥 기준)붉은 x 버튼이 클릭되면, 해당 창을 완전히 종료시킵니다.
  - P.S) Default 상태에서 mlx 라이브러리를 사용한 프로그램은 x 버튼을 그냥 누를 시 프로세스 자체는 죽지 않습니다. 창만 사라지게 됩니다.
- x 초 이상 길게 키를 누르면, 터미널에 무언가 표시되게 합니다.
- 마우스가 창 안으로 들어가게 되면, 터미널 상에 Hello! 라고 나오게 하고, 떠나면 Bye! 라고 출력되게 만듭니다.

주제별 라이브러리 설명(링크 참조)

해당 내용들은 분량이 너무 많은 관계로 링크로 대신 합니다.

1. Introduction

2. Getting Started

3. Colors

4. Hooks

5. Events

6. Loops

7. Images

8. Sync

- Events
주제별 라이브러리 설명(링크 참조)